Copyright: Copyright ® 1994-95, Top-Down Maintenance, Inc.


  Contents

Select the name of the menu name to access menu Help topics.

To learn how to use Help, press F1, or choose Using Help from the Help menu.

Main Menu

Batch Synchronization List Menu

Verification and Status Display Menu

About Menu

Using PeerSync


   Main Menu

Select functional areas of the drawing below to access Directory Synchronization Help topics.

To learn how to use Help, press F1, or choose Using Help from the Help menu.


Add

Add the selected file/directory combination to the list of directories to Synchronize using Batch Synchronization.

See also Item Count.


Batch Synchronization

Synchronize all selected file/directory combinations.

Automatic Synchronization at startup can be achieved by adding the string SYNCLISTx, where x can range from 0 to 5, to Command Line section of PeerSyncs properties.  Detailed instructions are contained in the Automatic Synchronization entry.


Go To

Go to the Batch Synchronization List Menu.


Item Count

The current number of file/directory selections made on the Batch Synchronization List Menu.  Each time the Add button is selected and the selected file/directory combination is not already a member of the list, the count will be incremented by one.


Files Updated

-- Left or Right

The number of files that were replaced in the Destination Directory during the Synchronize operation.


Files Added

-- Left or Right

The number of files that were added to the Destination Directory during the Synchronize operation.


Update Right

Copy the Selected Files from the directory named in the Left Directory Window to the Right Directory Window.


Update Left

Copy the Selected Files from the directory named in the Right Directory Window to the Left Directory Window.


Update Both

Perform an Update Left, and then an Update Right on the Selected Files in the Left Directory Window, and the Right Directory Window.


Synchronize

-- Synchronize Selected Directories

Perform the chosen synchronize action.  The Synchronize button/menu item will be enabled if either Update Existing Files or Add New Files is selected.


Add New Files

When chosen, all Selected Files in the Source Directory that are not in the Destination Directory will be copied into the Destination Directory.  The Synchronize button will be enabled if either Update Existing Files or Add New Files is selected.


Update Existing Files

When chosen, Selected Files in the Source Directory will update corresponding files in the Destination Directory if they are newer than the files in the Destination Directory.  The Synchronize button will be enabled if either Update Existing Files or Add New Files is selected.


Include Subdirectories

When chosen, all Selected Files in subdirectories of the Source Directory will be copied into the Destination Directory.  Subdirectories that do not exist in the Destination Directory will be created during the transfer process.


Source Directory

The directory FROM which the files are to be copied.  When Update Left is chosen, the directory named in the Right Directory Window is the source.  When Update Right is chosen, the directory named in the Left Directory Window is the source.


Destination Directory

The directory TO which the files are to be copied.  When Update Left is chosen, the directory named in the Left Directory Window is the Destination Directory.  When Update Right is chosen, the directory named in the Right Directory Window is the Destination Directory.


Destination Drive

The drive which contains the Destination Directory.


Source Drive

The drive which contains the Source Directory.


Left Directory Window

The directory structure shown under the label LEFT.


Right Directory Window

The directory structure shown under the label RIGHT.


Selected Files

All files in the Source Directory.  If Add New Files is not selected, only existing files in the Source Directory that are newer than corresponding files in the Destination Directory will be replaced in the Destination Directory.  If Add New Files is selected, then any files that are in the Source Directory that are not in the Destination Directory will be copied to the Destination Directory.  All files will also be updated as described in the previous sentence.


Exclude File Types

PeerSync will exclude from the synchronization the file types entered in this text box.  This function can be turned on and off using the Use Exclude File Types under the Options Menu.


File Filter

PeerSync will only display and select the file values entered in this text box.  To select all files, the *.* value should be entered in this text box.

See also Use File Filter.


File

The File selection menu item enables access to the following items:


Exit

Leave current process.


Create Directory
Create Directory Name

Use the PeerSync Create Directory function to create a new directory or subdirectory.  Select the location where you want to create a new directory and then select the Create Directory item under the File menu item.  Enter the new directory name (8 character limit) in the dialog box and select OK to create the new directory.


Create Directory Name
Directory Name

Enter the name of the directory to be created.


OK - Create Directory

Create the new directory named in the Create Directory menu and exit the menu.


Cancel - Create Directory

Exit the Create Directory menu without creating the directory.


Tools

The Tools selection menu item enables access to the following items:


Estimate Disk Space Required

This function gives an estimate of the disk space required to perform the Directory Synchronization.  It computes the total destination disk space required based upon the files that will be Added as well as those that will be Updated.  The number of files checked to make the estimate is indicated in the Files Checked field.


Avaiable Space
Available Space

Indicates the space available on the Destination Drive.


Files Checked

The number of file included in the Destination Drive Space Estimate.


Required Space

The amount of space that must be available on the Destination Drive in order to be able to make the selected Synchronization.


Run

Proceed with the space estimate.


Close - Space Estimate

Exit the Destination Drive Space Estimate menu.


Show File AttributesTypes

Archive: Indicates that this file has been changed since the last backup copy was made.  Indicated with a attribute.

Hidden: File that can not normally be seen using the file manager unless that property is changed by the user.  Indicated with h attribute.

Read Only: The file attribute prevents the file from being changed by the user.  Indicated with r attribute.

System: A file that is for the operation systems use; e. g., 386SPART.PAR (hsa), DBLSPACE.001 (rhs), etc.  Indicated with s attribute.

See File Manager Help for more details.


File Dates

The File Dates selection menu item enables access to the following items:


All

Selection of All enables PeerSync to select files with any date.


Date Range

Using the Date Range capability enables the user to set starting and ending dates for file presentation.  PeerSync will only choose files that are within this date range.


Relative Date

The user can set a semi-fixed range based upon todays date and a number of days in the past.


OK - File Dates

Accept and save selected File Date settings.


Cancel - File Dates

Return to Tools Menu item without accepting File Date changes.


OK - File Display

Accept and save selected File Display Option settings.


Cancel - File Display

Return to Tools Menu item without accepting File Display Option changes.


Set File Types to Display

Setting the file types will limit those files that will be displayed to the user in the Left and Right windows.


Options

The Options selection menu item enables access to the following items:


Display Unmatched Target Files

This function can be turned ON or OFF using this pull-down menu item.  When it is enabled, as denoted by a check mark to the left of it, it will display the files that are in the Destination Directory but are not in the Source Directory in the Non-Matching Target Directory Files dialog box.


Non-Matching Files

This portion of the dialog box contains files that are in the Destination Directory but are not in the Source Directory.


Excluded Matching Files

This portion of the dialog box contains files that are in the Destination Directory but are excluded from the synchronization process by the Exclude File Types parameter.


Select All

This function enables the user to select all files in both sections of the Non-Matching Target Directory Files dialog box.


Delete Selected Files

This function enables the user to delete all selected files in the Non-Matching Target Directory Files dialog boxes.


Close Non-Matching
Close - Non-Matching

Exit the Non-Matching Target Directory Files dialog box.


Use Exclude File Types

When this item is selected, as denoted by a check mark to the left of it, the file types entered in the Exclude File Types text box on the Directory Syncronization menu are excluded from the synchronization process.


Help

Access the PeerSync Help items as shown below:


Search

Access the list of PeerSync key words.


Close - Directory Sync

Exit Directory Synchronization.


Directory Selection Menu
 Batch Synchronization List Menu

Select functional areas of the drawing below to access Batch Synchronization List Menu Help topics.

To learn how to use Help, press F1, or choose Using Help from the Help menu.


Current List Name

The name of the current Synchronization List.


List Description

The description of the Current List.


Selection Box

An X in a Selection Box indicates that the file/directory combination shown in the Left Directory and Right Directory windows has been selected, and will be processed when the Synchronize List button is pressed.


Sync

-- Synchronization Direction

The direction in which the files will be transferred:

<-- means that the file/directory combination named in the Left Directory will be synchronized with the Right Directory.

--> means that the file/directory combination named in the Right Directory will be synchronized with the Left Directory.

<--> means that the file/directory combinations named in the Right Directory and Left Directory windows will both be synchronized with each other.


Left Directory

The directory shown on the left side of the menu.  This directory can be either the Source Directory or the Destination Directory based upon the direction indicated in the Sync field.


Right Directory

The directory shown on the right side of the menu.  This directory can be either the Source Directory or the Destination Directory based upon the direction indicated in the Sync field.


Delete

Remove all file/directory combinations from the list that do not have an X in the Selection Box.


Synchronize List

Process the file/directory selection shown in the Batch Synchronization List Menu.


File - Batch Sync

The File selection menu item enables access to the following items:


Load Listing

The user can select one of the listed Synchronization Listing shown in the pull-down extension.  This will then be loaded into PeerSync.  Each listing contains the parameters for both Directories, Sync, Add New, Update Existing, Inc Sub, Excluded File Types, and File Filter.


Save Listing

The Save Listing selection menu item enables access to the following items


Save - Synchronization List

Save the current settings into the chosen list number with the stated description.


Cancel - Synchronization List

Exit the Save Synchronization List menu without saving the current values.


Sync List Names

The list of available Synchronization Listings.


Edit

The Edit selection menu item enables access to the following items:


Add Blank List Item

Use this function to add a new synchronization line to the Batch Synchronization List.


Close - Batch Sync

Exit the Batch Synchronization List menu.


  Verification and Status Display Menu

Select functional areas of the drawing below to access the Verification and Status Display Menu Help topics.

To learn how to use Help, press F1, or choose Using Help from the Help menu.


Update Directory

There are three different update methods: Update Left, Update Right and Update Both.


File Date Setting

Indicates which file dates will be synchronized.  Options include All, Date Range or Relative Range.

See also Use File Dates.


Source File Size

The size of the current file being transferred.


Destination Disk Space Remaining

The disk space remaining on the Destination Drive.


Append Log

When selected, the log created during this synchronization process will be appended the end of the existing log, or a new log will be created if one does not exit.


Display Messages

When selected, all messages will be displayed to the user.  If not selected, error messages will be placed in the log and NOT displayed to the user when they occur.


Proceed

Process those file/directory selections shown in the Source and Destination Directory selections.


Cancel - Verification

Do not process those file/directory selections shown in the Source and Destination Directory selections.


About
   About Menu

Select functional areas of the drawing below to access About Menu Help topics.

To learn how to use Help, press F1, or choose Using Help from the Help menu.

Unregistered Version

Registered Version


OK - ABOUT

Accept the current setting and return to the Main Menu.


Registration

This is a fully functional version of PEERSYNC.EXE.  Use this product for 20 days to evaluate it's value to you.  If after this period you find this application useful, please register with Top-Down.  This registration fee is the only compensation Top-Down receives for this product and the only funding available for further development of this, and other applications.

PEERSYNC.EXE can be registered by sending a check, or money order for $18(US) to:

Top-Down Maintenance, Inc.

1363 Veterans Highway, Suite 44

Hauppauge, NY 11788

Or

VIA CompuServe (GO SWREG) ID # 4179.

Upon receipt of registration fee, a fully registered copy of PEERSYNC.EXE will be sent either by U. S. Mail, or via CompuServe, if registered by CompuServe.  Also, if you register via CompuServe, you MUST include your CompuServe address with your registration.  Registered users will be sent a copy of the next release, when it becomes available.

Please Fax (516.979.1870), or CompuServe (74521,1261) any comments you may have that can help us to improve this product.

PEERSYNC.EXE may not be commercially distributed, distributed by government agencies or any of its contractors, UNLESS a registration fee is paid by the distributing party for each copy that is distributed.  Special arrangements for large distributions, or site licenses can be made with Top-Down.  Please contact TopDown for details.

This file may not be included in CD-ROM distributions, bundled with other files, or offered for retail sale without contacting Top-Down Maintenance, Inc. and obtaining a license.

TERMS AND CONDITIONS

READ THIS BEFORE USING THIS PROGRAM. BY USING THIS PROGRAM, YOU ARE AGREEING TO THESE TERMS AND CONDITIONS.

TOP-DOWN MAINTENANCE, INC. SPECIFICALLY DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THIS PROGRAM.  TOP-DOWN MAINTENANCE, INC . SHALL HAVE NO LIABILITY WITH RESPECT TO ANY LOSS OR DAMAGE DIRECTLY OR INDIRECTLY ARISING OUT OF THE USE OF THIS PROGRAM. WITHOUT LIMITING THE FOREGOING, TOP-DOWN MAINTENANCE, INC.  SHALL NOT BE LIABLE FOR ANY LOSS OF PROFIT, INTERRUPTION OF BUSINESS, DAMAGE TO EQUIPMENT OR DATA, INTERRUPTION OF OPERATIONS OR ANY OTHER DAMAGE, INCLUDING BUT NOT LIMITED TO DIRECT, INDIRECT, SPECIAL, INCIDENTAL, CONSEQUENTIAL OR OTHER DAMAGES.

The proprietor of PEERSYNC.EXE is Top-Down Maintenance, Inc. 1363 Veterans Highway, Suite 44, Hauppauge, NY 11788

Copyright (c) 1994-95 Top-Down Maintenance, Inc.  All Rights Reserved.  Reproduction in whole or in part without permission is prohibited.


Automatic Synchronization

The directories setup in the Batch Synchronization List Menu can be automatically synchronized by PeerSync at startup by entering the string SYNCLISTx, where x can be any value between 0 and 5.  The SYNCLISTx string can be followed by a time value; i. e., 0, or a value greater than 0.  If the value 0 follows SYNCLISTx (e. g., SYNCLIST5 0), then the synchronization will be carried out immediately.  If some value greater than 0 follows SYNCLISTx (e. g., SYNCLIST1 10), then a timer will postpone the synchronization action.  While the timer is running, the user will be able to cancel the synchronization action using the CANCEL button that will be presented to the user.  If no value is entered following SYNCLISTx, a 10 second delay will be applied automatically.

WARNING

The file/directory selection values left in the Batch Synchronization List Menu during the last Batch Synchronization synchronization are those file/directory selection values that will be synchronized during automatic operation.

Automatic Synchronization can be applied in either of two ways: at System Startup, or at PeerSync Startup.

•	System Startup: To automatically synchronize the file/directory selection shown in the Batch Synchronization List Menu during the Windows startup process:

1.  Add a PeerSync icon to the Startup Window.

2.  Select this icon, and then select the Properties menu item under the File menu.

3.  In the Command Line entry box, add a space and the string SYNCLISTx after the PEERSYNC.EXE entry.

4.  Add a space and the time value of 0 after the SYNCLISTx string as shown below.  Note: If the user wants to have time to cancel Automatic Synchronization during startup, the user can either enter no value (creates a 10 second delay), or a value greater than 0.

•	PeerSync Startup: To automatically synchronize the file/directory selection shown in the Batch Synchronization List Menu during the PeerSync startup process:

1.  Select the PeerSync icon, and then select the Properties menu item under the File menu.

2.  In the Command Line entry box, add a space and the string SYNCLISTx after the PEERSYNC.EXE entry.

3.  Add a space and a time value after the SYNCLISTx string as shown below.  Note: If no value is entered, PeerSync automatically creates a 10 second delay.


   Using PeerSync

Select functional areas of the drawing below to access About Menu Help topics.

To learn how to use Help, press F1, or choose Using Help from the Help menu.

Selecting Drives

Selecting Directories & Files

Source & Destination Directory Selection

Update, Add and Include Settings

File Exclusion

Use File Filter

Use File Dates

Use File Types

Use Synchronization

Use Batch Synchronization


Selecting Drives

Selecting a drive is depicted in the Right section of the Directory Synchronization menu, which is shown below.  First, extend the selection list by clicking the down arrow to the right of the drive combo box, which shows d:[\\HANDBOOK\C] being selected in this case.  Second, point the mouse at the name of the drive you want to chose, and select the desired drive by clicking on the drive name and description.


Selecting Directories & Files

Selected path names (i. e., drive\\directory combination) appear in the text boxes just below the words Left and Right; e. g., Left: C:\ICAT26\ET\MODELS, and Right: D:\.

To select the desired directory:

Choose the drive where the directory resides.

Select (single-click) on the drive name that appears at the top of the directory tree structure (C:\).  This will create the list of root level directories directly under the drives name.

Expose the desired directory/subdirectory by repeatedly single-clicking on the appropriate directory or subdirectory name until the full path name appears in the path name window; e. g., C:\ICAT26\ET\MODELS.  The files that are in the selected directory appear in the vertical list box to the right of the directory tree and drive name windows.  All files listed in this window will be acted upon as established by the entries in the Set File Types to Display and Set File Dates to Include menu items under the Tools menu.


Source & Destination Directory Selection

The definition of the Source and Destination directories is determined by the setting of the Update Right Directory, Update Left Directory, or Update Both Directories.

Update Right Directory: Selection of this option makes the Left the Source and the Right the Destination.

Update Left Directory: Selection of this option makes the Right the Source and the Left the Destination.

Update Both Directories: When this option is selected, PeerSync first performs an Update Right Directory and then an Update Left Directory.


Update, Add and Include Settings

Before beginning the synchronization process, the user must set the three remaining parameters as required: Update Existing File, Add New Files and Include Sub Directories.


File Exclusion

The File Exclusion function enables the user to exclude files by type.  Enter the exclusion values into the list and separate them with a semicolon.  One set of exclusion values will be used for the Single-Selection and another for the Batch Synchronization.

See also Set File Types to Display, Set File Dates to Include, and Tools.


Use File Filter

The File Filter function enables the user to select by either a specific file type or file name.  When one or more filter values are entered, only those files with these values will be displayed in the Left and Right Directories and acted upon by PeerSync.  Different File Filter values must be separated by a semicolon.  All files can be chosen by using the star-dot-star string -- *.*.  Separate sets of filters are used for the Single-Selection and another for the Batch Synchronization.


Use File Dates

Files can be included/excluded using the Set File Dates to Include capability under the Tools menu.  Three methods can be used: All, Date Range, or Relative Range.  When All is selected, all files dates will be included.  When Date Range is used, only those files which fall within the From and To dates will be chosen.  The Relative Range uses todays date minus the number entered into the Past box.  The menu item Use Exclude File Types, which is on the Options menu, must be turned ON; i. e., check mark on left side of menu item, to enable the file types to be excluded.


Use File Types

One or more of the standard file types (Archive, Read Only, System, and Hidden) can be selected or excluded using this feature.  These inclusions/exclusions are made using the Set File Types to Display under the Tools menu.


Use Synchronization

After the Source and Destination directories and associated parameters have been setup, the user clicks on the Synchronize button to start the process.  The Verification and Status Display Menu menu will then appear.  This menu indicates both the Source and Destination directories and the status of the Append Log and Display Messages functions. Set the Append Log and Display Messages parameters as required for this synchronization.  The user can then either Proceed or Cancel the operation.


Use Batch Synchronization

The Batch Synchronization List menu contains those items that will be synchronized during Batch Synchronizaton.  The values are setup using the Left and Right drive/directory selection controls as well as the Use File Dates, Exclude File Types and File Filter sections of the Directory Synchroniczation menu.

Note: If the Item Count value is greater than zero, then the Go To button will be activated and the user can go to the Batch Synchronization List menu by clicking the Go To button.  The user can then activate or deactivate any file/directory combinations to be synchronized during this session by selecting/deselecting them.  Deactivated combinations can either be left in the list, or removed by clicking on the Delete UnChecked Items button.

Batch Synchronization is implemented as follows:

1.  Setup a file/directory combination by setting the Source and Destination values.  See Selecting Drives, and Selecting Directories & Files.

2.  Set the three remaining parameters: Update Existing File, Add New Files and Include SubDirectories as required.

3.  Click the Add button.  The Item Count will be incremented by one.

4.  Repeat Steps 1, 2, and 3 until all file/directory combinations have been entered into the Batch Synchronization List.

5.  Go to the Batch Synchronization List menu by clicking on the Go To button.

6.  This set of directory selections can be saved for future use under one of the six (0 to 5) SYNCLISTx values using Save Listing function under the Batch Synchronizations File menu item.

7.  Review the list to verify that all values are correct.

8.  Press the Synchronize List button.

9.  The Verification and Status Display menu will pop-up.  This menu indicates both the Source and Destination directories and the status of the Append Log and Display Messages functions.  Set the Append Log and Display Messages parameters as required for this synchronization.

10.  Select either Proceed or Cancel.

11.  If Display Messages is active, note any error messages.  Otherwise, review the PeerSync Activity Log for errors as described in the section PeerSync Activity Log.

12.  After the synchronization session is finished, the user may either perform another synchronization or Close the Batch Synchronization List menu.


PeerSync Activity Log

PeerSync records file movements in the file PEERSYNC.LOG, which is located in the directory where PEERSYNC.EXE is located -- generally, C:\PEERSYNC.  It can be opened by any text processor; i.e., WRITE, WORD, NOTEPAD, etc.  Note: NOTEPAD  can not open files that are larger than 64K.  If the log file gets too large, you can delete it and a new one will be created the next time you use PeerSync.

The following section contains an excerpt from a PEERSYNC.LOG file.

Synchronization Log Created: 08:22:08

Successful File Add:    C:\AUTOEXEC.000  --->  C:\TEMP\AUTOEXEC.000  ---  9/15/94 20:46:16

Successful File Add:    C:\CHKLIST.CPS  --->  C:\TEMP\CHKLIST.CPS  ---  1/5/94 02:08:22

Successful File Add:    C:\CHKLIST.MS  --->  C:\TEMP\CHKLIST.MS  ---  12/26/93 21:28:56

Successful File Add:    C:\ICAT.GRP  --->  C:\TEMP\ICAT.GRP  ---  2/27/95 21:02:58

Successful File Add:    C:\TREEINFO.DT  --->  C:\TEMP\TREEINFO.DT  ---  1/16/95 19:06:14

Successful File Add:    C:\TREEINFO.NCD  --->  C:\TEMP\TREEINFO.NCD  ---  1/16/95 19:06:14

Synchronization Completed!

Files Copied = 10

Files Updated = 0

Total Files Checked = 10

Elapsed Time: 2 Seconds